home *** CD-ROM | disk | FTP | other *** search
/ Alles Voor Internet / Tout Pour Internet / alles voor internet.iso / MacInternet™ / Telnet / Termy-2.3 / Termy TEXT < prev   
Text File  |  1993-09-15  |  14KB  |  331 lines
  1.  
  2.  
  3. Termy
  4.  
  5. By Tim Endres
  6.  
  7. Release 2.3
  8.  
  9.  
  10.  
  11. Tim Endres, ICE Engineering, Inc.
  12. 8840 Main Street, Whitmore Lake, MI  48189
  13. Internet:  termy@ice.com
  14. Copyrighted © 1988-1992 By ICE Engineering, Inc.
  15.  
  16.  
  17.  
  18. Table Of Contents
  19. Introduction    1
  20. NOTICE - DISCLAIMER    1
  21. Basics    2
  22. Communications Toolbox    2
  23. Getting Started    3
  24. Installing The CTB    3
  25. Installing The CTB Tools    3
  26. Installing Termy    4
  27. Using Termy    5
  28. Terminals    5
  29. Configuring a Terminal    5
  30. Configuring The Terminal Connection    6
  31. Configuring The Terminal Terminal    6
  32. Deleting A Terminal Definition    7
  33. Termy Features    8
  34. File Conversion Utilities    8
  35. Text Editor    8
  36.  
  37. Introduction
  38.  
  39. Termy is a terminal emulation application and more that utilizes the 
  40. Macintosh Communications Toolbox (CTB). The CTB allows Termy to be 
  41. written for a single communications standard, and then used for any and 
  42. all extensions written by other developers. A fantastic approach to solving 
  43. the communications problem.
  44.  
  45. Termy used to be named uATerminal. Its name was changed because, 
  46. well, to be honest uATerminal is a dull name. Termy seems more 
  47. endearing.
  48.  
  49. Termy was created by taking the terminal emulation software from the 
  50. commercial product uAccess and making a stand alone application.We 
  51. have done this because we derive our living from the Internet, and feel 
  52. compelled to give back as much as we possibly can.
  53.  
  54. The most difficult aspect of using Termy for most people is simply the 
  55. installation of the CTB. It is different for System Six and System Seven. It is 
  56. also more complicated than most application installations. However, once 
  57. you have passed this hurdle, the remainder of the application is 
  58. surprisingly straight forward.
  59.  
  60. Termy is to be distributed free. It may not be distributed as part of any 
  61. commercial package, without the expressed written consent of ICE 
  62. Engineering, Inc. Termy may not be distributed without the proper 
  63. copyright and distribution notices contained within the software itself and 
  64. in this manual.
  65.  
  66.  
  67. *** NOTICE - DISCLAIMER
  68. *** 
  69. *** Termy is Copyrighted 1988-1992 © By ICE Engineering, Inc., and Tim Endres.
  70. *** 
  71. *** Termy is provided AS-IS with no warranty as to its functionality or stability. 
  72. *** The user of this software assumes all responsibility for its use and all resulting 
  73. *** consequences of that use. Neither ICE Engineering, Inc., or Tim Endres, will 
  74. *** assume responsibility in any way for consequences resulting from the use of 
  75. *** this software, which is distributed free of charge with full disclaimer.
  76. *** 
  77. *** NOTICE - DISCLAIMER
  78.  
  79. Basics
  80.  
  81. Communications Toolbox
  82.  
  83. The Communications Toolbox (CTB) is founded on a very simple principal –
  84. most data communications are based on the three basic 
  85. functions of connection, transfer of data, and display of data.
  86.  
  87. The novelty of the CTB is that previously each application had to write code 
  88. that dealt specifically with each type of connection that it made, and each 
  89. application had this redundant code contained within it.
  90.  
  91. Thus, is an application wanted to send data through the Serial Port via 
  92. modem to another Macintosh, and also wanted to send data over AppleTalk 
  93. to another Macintosh, then the application would have to contain code to 
  94. handle the serial port, as well as code to handle the AppleTalk network.
  95. Intelligent software designers thought – why doesn't someone write the 
  96. AppleTalk code once and then everyone can use it.
  97.  
  98. Thus, the CTB was designed. With the CTB, the application developer 
  99. writes code to one interface, the CTB interface. Then, the user selects from 
  100. CTB tools to determine what the CTB interface actually does. Thus, the 
  101. application never really knows where its data comes from, or how it is sent, 
  102. it simply receives and sends data via the CTB. The CTB tools handle the 
  103. task of getting the data physically moved from place to place.
  104.  
  105. The CTB goes beyond standardizing the data connection, it also 
  106. standardizes the terminal interface, or the display of your data, and it 
  107. standardizes the transfer interface, or the sending of files between 
  108. computers. The three parts of the CTB are called the Connection Manager, 
  109. Terminal Manager, and Transfer Manager.
  110.  
  111. Each manager has tools. These tools are files that you place in your System 
  112. Folder. The files have icons that look like little puzzle pieces. These files 
  113. contains code and resources that provide the CTB with functionality.
  114. For example, the Serial Tool is a communication tool that provides data 
  115. communication via the Macintosh built in serial port. The AppleTalk ADSP 
  116. Tool provides data communications via the AppleTalk network. The VT102 
  117. Tool is a terminal tool that provides vt102 terminal emulation in a window. 
  118. The XMODEM Tool is a transfer tool that provides file transfers via the 
  119. XMODEM protocol, which is popular for modem based connections.
  120.  
  121. The beauty of the CTB is that anyone can develop a new tool and it will be 
  122. usable by the CTB and therefore by Termy. For instance, if you suddenly 
  123. needed to connect to an SNA network, then a communications tool could be 
  124. developed that knew how to communicate with SNA.
  125.  
  126.  
  127. Getting Started
  128.  
  129. Installing The CTB
  130.  
  131. Users of System Seven do not need to install the CTB, since the CTB is built 
  132. into System Seven. Please skip to the Installing the CTB Tools section.
  133. Users of System Six have a much more difficult prospect when it comes to 
  134. installing the CTB. In order to install the CTB, you need a CTB Installation 
  135. Floppy. This contains the Installer program and an install script. Without 
  136. this floppy, you will not be able to get started.
  137.  
  138. Most CTB based commercial applications (uAccess for instance) come with 
  139. a CTB installation floppy. ICE Engineering will ship you one, but it costs 
  140. $15. However, most public data sites, such as the Internet, CompuServe, 
  141. and others, have the CTB installation floppy on-line for downloading.
  142.  
  143. Once you have acquired a CTB Installation floppy, you must boot the 
  144. Macintosh from the floppy. Once the Finder is available, double click on the 
  145. Installer Script file. This will launch the Installer application. Once the 
  146. Installer application has been launched, select your hard disk for the 
  147. installation location, and click the Easy Install button.
  148.  
  149. Once the installation is complete, you must reboot from your hard disk in 
  150. order to use the CTB.
  151.  
  152.  
  153. Installing The CTB Tools
  154.  
  155. Since the CTB is really only a frame work, you must install CTB Tools to be 
  156. able to actually perform any communications.
  157.  
  158. NOTE:    If you get an error #8 starting Termy, you  did not perform this
  159.         step correctly!
  160. Again, the installation of the CTB Tools is different between System Six and 
  161.  
  162. System Seven.
  163.  
  164. System Seven users must install the CTB Tools in the "Extensions" folder 
  165. inside the "System Folder". Copy all of the CTB Tools that you intend to use 
  166. into your Extensions folder inside the System Folder.
  167.  
  168. System Six users must install the CTB Tools in the "Communications 
  169. Folder" folder inside the "System Folder". Copy all of the CTB Tools that you 
  170. intend to use into your Extensions folder inside the System Folder.
  171. There must be at least one of each type of tool (connection, terminal, 
  172. transfer), or Termy will complain at startup time. Termy will not work 
  173. without a connection tool and a terminal tool, but can work without any 
  174. transfer tools.
  175.  
  176.  
  177. Installing Termy
  178.  
  179. Installing Termy is very simple. Copy Termy to your hard disk.
  180. Termy requires a preference file. This file is placed in the "Preferences" 
  181. folder in the "System Folder" for System Seven users. The preference file is 
  182. placed in the "System Folder" for System Six users. The preference file is 
  183. named "Termy Preferences".
  184.  
  185. Termy will automatically create a preference file if one is not found.
  186.  
  187.  
  188. Using Termy
  189.  
  190. Terminals
  191.  
  192. There is a basic concept in Termy. Terminals. Terminals are windows that 
  193. allow you to communicate with other computers. You must define each 
  194. terminal that you use. Fortunately, most people use only one terminal.
  195. Termy provides you with a default terminal. This is the first terminal you 
  196. should configure, since it is always available.
  197.  
  198. You may create new terminals with the New Terminal command in the 
  199. Config menu. Terminals are identified by a name.
  200.  
  201. You open a terminal via the Terminals submenu in the Terminal menu. 
  202. The first item on the terminals submenu is Default Terminal. If you define 
  203. other terminals, their names will appear below the default terminal.
  204. Selecting one of the names in the terminals submenu will open a window 
  205. that uses the Terminal Tool configured for the selected terminal, and 
  206. communicates with the Connection Tool configured for the selected 
  207. terminal. File transfers will be performed with the Transfer Tool 
  208. configured for the selected terminal.
  209.  
  210. Closing the terminal window will cause its communications connection to 
  211. be closed. This is why you are asked first before closing a terminal window.
  212.  
  213.  
  214. Configuring a Terminal
  215.  
  216. To configure a terminal, you must first define the terminal's name. This is 
  217. done with the New Terminal command in the Config menu. This 
  218. command will prompt you for a name for the new terminal. Of course, the 
  219. default terminal is always defined, so you do not need to use the new 
  220. terminal command to create it.
  221.  
  222. Configuring a terminal is a two step process. Since the configuration of a 
  223. terminal's terminal tool and transfer tool require a connection and a 
  224. window, you must first configure the connection tool for the terminal. This 
  225. is why the Terminal and Transfer commands are dim in the Config menu.
  226.  
  227. Select a terminal name from the Connection submenu in the Config menu. 
  228. For now, use the Default Terminal. This will display a large dialog box that 
  229. is the CTB Connection Tool Configuration Dialog. This dialog box will allow 
  230. you to select any connection tool and configure it for use.
  231.  
  232.  
  233. Configuring The Terminal Connection
  234.  
  235. Once you have displayed the connection tool configuration dialog by 
  236. selecting a terminal name from the Connection submenu in the Config 
  237. menu, you will need to select a connection tool.
  238.  
  239. You select a connection tool from the popup menu in the upper left area of 
  240. the dialog box. This popup menu should have choices such as Serial Tool, 
  241. AppleTalk ADSP Tool, and Apple Modem Tool. These names depend upon 
  242. the tool files that you installed in your System Folder.
  243.  
  244. The Serial Tool is used to communicate directly with the serial port and any 
  245. device attached to it, such as a modem or other computer. The Apple 
  246. Modem Tool also communicates using the serial port, but it also performs 
  247. the functions of dialing the modem and hanging up. The AppleTalk ADSP 
  248. Tool communicates with other Macintosh computers over the AppleTalk 
  249. network.
  250.  
  251. Describing the details of each tool's configuration is beyond the scope of this 
  252. manual, but documentation for these tools is available from several 
  253. sources, including your bookstore.
  254.  
  255. Selecting a tool in the popup menu will display the tool's specific 
  256. configuration information. This configuration is usually fairly straight 
  257. forward.
  258.  
  259. Configuring The Terminal Terminal
  260.  
  261. Once you have configured the terminal's connection, you must open the 
  262. terminal to configure its terminal and transfer tools.
  263. You open a terminal using the Terminals submenu in the Terminal menu. 
  264. Select the default terminal and it will open a window for the terminal and 
  265. attempt to open its connection tool.
  266.  
  267. If the connection is successfully opened, the terminal window will be 
  268. displayed and should contain a blinking cursor.
  269. Once the terminal window is open, you may configure its terminal tool and 
  270. transfer tool using the Terminal and Transfer commands in the Config 
  271. menu. You can also configure the terminal tool via the Configure 
  272. command in the Terminal menu, and the transfer tool via the Configure 
  273. command in the Transfers submenu in the Terminal menu.
  274.  
  275. Again, configuring the terminal tool or transfer tool will cause the CTB to 
  276. display a dialog box with a popup menu in the upper left area for selecting 
  277. the desired tool and information specific to the tool in the lower area of the 
  278. dialog.
  279.  
  280. Deleting A Terminal Definition
  281.  
  282. Selecting one of the definition names from the Delete Terminal submenu in 
  283. the Config menu will cause that terminal's definition for connection, 
  284. terminal and transfer tools to be deleted. The terminal definition will also 
  285. be removed from all of the submenus in which it appears.
  286. This operation can not be undone.
  287.  
  288.  
  289. Termy Features
  290.  
  291. File Conversion Utilities
  292.  
  293. Because the world of data communications frequently requires that data be 
  294. mapped from one computer's representation to another's, Termy includes 
  295. a list of file conversion utilities.
  296.  
  297. The conversions provided by Termy are all contained in the Tools menu. 
  298. The tools allow you to convert text from UNIX or PC systems for use on the 
  299. Mac and vice-versa. The other tools provided are MacBinary, BinHex, and 
  300. uuencode.
  301.  
  302. NOTE, Termy can not convert a file in place. This means that the data 
  303. resulting from a file conversion must be placed in a file other than the one 
  304. being converted.
  305.  
  306. Text Editor
  307.  
  308. Termy provides a text editor. This editor is driven by the commands in the 
  309. top part of the File menu and the commands in the Edit menu.
  310.  
  311. Termy windows can display text of any length, but perform best when 
  312. displaying data from a file, as opposed to text pasted into a Termy text 
  313. window.
  314.  
  315. Termy text windows, do not work like regular Macintosh windows. Termy 
  316. text windows automatically wrap lines, but in so wrapping they insert a 
  317. carriage return, making the wrap "permanent". The little arrow at the 
  318. lower left of the Termy text windows indicates if lines are wrapped or not. If 
  319. the arrow is straight, lines are not wrapped, otherwise they are.
  320. The commands in the Selection submenu in the Edit menu, will operate on 
  321. the currently selected text in the front most text window.
  322.  
  323. You may configure the font displayed in the Text Windows and the font 
  324. used when the window is printed via the Text Windows... command in the 
  325. Config menu. This will display a dialog box within which you may 
  326. configure the text window settings.
  327.  
  328. The font settings will affect both the text displayed on the screen and text 
  329. that is printed. You may also configure the tabs and line wrap settings.
  330.  
  331.